README for nKill.exe, version 1.0
copyright 2002, Julian Robichaux
www.nsftools.com


DESCRIPTION
nKill is a command-line program that lists or kills running processes on your computer. It does essentially the same thing as the kill.exe and the tlist.exe programs from the NT Resource Kit, except the functionality for both programs is rolled into one. I added a /d option so you can kill all processes that match programs found in a given directory (which is good for listing or killing everything that might be associated with a program in that directory, for instance). You can also use wildcard characters to list or kill all processes that match a certain pattern, like "n*.exe".


REQUIREMENTS
Windows 95/98/NT/2000


INSTALLATION
Copy the nKill.exe program anywhere on your hard drive. Put it in a directory on the PATH if you want to be able to run it from any directory. Run it from a command prompt, as described below.


USAGE
Usage: nKill [pid|task name] [/l] [/d[:dir name]]

  pid|task name   The number of a process ID or the name of a task that
                  you would like to list or kill. You can use wildcards in
                  the task name to list or kill all tasks matching a pattern.
  /l              List all tasks, or tasks specified by pid, task name, or
                  directory name (or a combination of these). If this flag
                  isn't specified, the tasks will be forcibly killed.
  /d              By itself, specifying this parameter will list or kill only
                  the processes that match files in the current directory.
                  If a task name is also specified, only tasks that match
                  the task name or pattern in the current directory will be
                  listed or forcibly killed.
  /d:dir name     If a directory name is specified after the /d parameter,
                  the action performed will be the same as if the /d
                  parameter is specified, except the specified directory will
                  be searched for tasks instead of the current directory.


EXAMPLES
To list all running processes:
  nKill /l

To list all running processes that start with the letter 'w':
  nKill w* /l

To kill the process with PID number 123
  nKill 123

To list all running processes that match programs in the current directory:
  nkill /l /d

To kill all running processes that match programs in the current directory:
  nkill /d

To kill all running processes that match programs in the 'C:\BadProgram' directory:
  nkill /d:C:\BadProgram

To kill all running processes that match programs in the 'C:\Program Files\BadProgram' directory:
  nkill "/d:C:\Program Files\BadProgram"


KNOWN PROBLEMS
None.


VERSION HISTORY
Version 1.0
-  Initial release

